Crate submillisecond

Submillisecond is a lunatic web framework.

Usage

First, add submillisecond as a dependency in Cargo.toml:

[dependencies]
submillisecond = "0.1"

Then, add a .cargo/config.toml to configure the target and runner:

[build]
target = "wasm32-wasi"

[target.wasm32-wasi]
runner = "lunatic"

Finally, define a handler and router, and run your application:

use submillisecond::{router, Application};

fn index() -> &'static str {
    "Hello from Submillisecond!"
}

fn main() -> std::io::Result<()> {
    Application::new(router! {
        GET "/" => index
    })
    .serve("0.0.0.0:3000")
}

The submillisecond repository has some more examples to help you get started.

High-level features

Submillisecond has some notable features including:

• Router macro for performant router generated at compile-time.
• Handlers: functions taking any number of extractors and returning any type that implements IntoResponse.
• Extractors: types that parse the request to provide useful data.
• Middleware: any handler which calls req.next_handler().
• Guards: types that protect routes per request.

Re-exports

• pub use headers;
• pub use http;

Modules

• cookiescookies
  Cookies layer and extractor.
• defaults
  Default responses for errors.
• extract
  Types and traits for extracting data from requests.
• params
  Params are data from the request url.
• reader
  Uri reader using a cursor.
• response
  Types and traits for http responses.
• sessioncookies
  Session data stored in encrypted user cookie.
• state
  Application state stored in a long running process.
• templatetemplate
• websocketwebsocket
  Websockets.

Macros

• router
  Macro for defining a router in submillisecond.
• static_router
  The static router can be used to serve static files within a folder.

Structs

• Application
  An application containing a router for listening and handling incoming requests.
• Body
  The request body.
• Error
  Errors that can happen when using submillisecond.
• Function
  Marker type for functions that satisfy ProcessSafeHandler.
• Jsonjson
  Json can be used as an extractor, or response type.
• Object
  Marker type for objects that satisfy ProcessSafeHandler.
• RequestContext
  Wrapper for http::Request containing params and cursor.
• TypedHeader
  Extractor and response that works with typed header values from headers.

Traits

• Guard
  Types which implement Guard can be used to protect routes.
• Handler
  A handler is implemented for any function which takes any number of extractors, and returns any type that implements IntoResponse.
• ProcessSafeHandler
  Implemented for process-safe Handlers.

Type Definitions

• BoxError
  Alias for a type-erased error type.
• Router
  Signature of router function generated by the router! macro.

Derive Macros

• NamedParam
  The NamedParam derive macro can be used to implement FromRequest for a struct.